adTempus API
PreviousUpNext
IScheduler::GetInstancesForRequest Method

Gets the instances associated with an execution request.

C++
HRESULT GetInstancesForRequest(BSTR ExecutionRequestID, [out,retval] IADTObjects** instances);
C#
GetInstancesForRequest(String ExecutionRequestID, [out,retval] IADTObjects* instances);
Visual Basic
Sub GetInstancesForRequest(ExecutionRequestID As String, instances As [out,retval] IADTObjects*)

 

When a job is submitted for execution using the ExecuteJob method the ExecutionRequestID value from the JobExecutionOptions object is associated with all job instances that are executed as a result of that request. GetInstancesForRequest gets those instances.

The instances may not be available immediately, as job execution does not begin immediately. If the job is being executed on an Agent, it may take several seconds for the request to be sent to the Agent and history information to be returned from the Agent after execution begins.

adTempus API Reference version 3.0.0.0, revised 10/30/2008